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yp The following identified U.S. patent applications are also relied upon and are 

r*. incorporated by reference in this application: 

y3 U.S. Patent Application No. 09/680,065, entitled "Method And System For 
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?H 1 5 Displaying Changes Of Source Code," filed on October 4, 2000; 

yi U.S. Patent Application No. 09/680,030, entitled "Method And System For 

□ Generating, Applying, And Defining A Pattern," filed on October 4, 2000; 

2= U.S. Patent Application No. 09/680,064, entitled "Method And System For 

S Collapsing A Graphical Representation Of Related Elements," filed on October 4, 2000; 

M 20 U.S. Patent Application No. , entitled "Methods and Systems for 

Generating Source Code for Object Oriented Elements," bearing attorney docket no. 
30013630-0008, and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Methods and Systems for 

Relating Data Structures and Object Oriented Elements for Distributed Computing," 
25 bearing attorney docket no. 30013630-0009, and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Methods and Systems for 

Finding and Displaying Linked Objects," bearing attorney docket no. 30013630-0012, 
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U.S. Patent Application No. , entitled "Methods and Systems for 

Supporting and Deploying Distributed Computing Components," bearing attorney docket 
no. 30013630-0014, and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Diagrammatic Control of 

5 a Software in a Version Control System," bearing attorney docket no. 30013630-0015, 
and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Navigation Links in 

Generated Documentation," bearing attorney docket no. 30013630-0016, and filed on the 
same date herewith; 

10 U.S. Patent Application No. , entitled "Methods and Systems for 

Identifying Dependencies Between Object-Oriented Elements," bearing attorney docket 
no. 30013630-0019, and filed on the same date herewith; and 

U.S. Patent Application No. , entitled "Methods and Systems for 

Relating a Data Definition File and a Data Model for Distributed Computing," bearing 

15 attorney docket no. 30013630-0020, and filed on the same date herewith. 

Field Of The Invention 

The present invention relates to a method and system for developing software. 
More particularly, the invention relates to a method and system for locating source code 
corresponding to a message from a verification tool. 

20 Background Of The Invention 

Computer instructions are written in source code. Although a skilled 
programmer can understand source code to determine what the code is designed to 
accomplish, with highly complex software systems, a graphical representation or model 
of the source code is helpful to organize and visualize the structure and components of 

25 the system. Using models, the complex systems are easily identified, and the structural 
and behavioral patterns can be visualized and documented. 

The well-known Unified Modeling Language (UML) is a general-purpose 
notational language for visualizing, specifying, constructing, and documenting complex 
software systems. UML is used to model systems ranging from business information 

30 systems to Web-based distributed systems, to real-time embedded systems. UML 
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formalizes the notion that real-world objects are best modeled as self-contained entities 
that contain both data and functionality. UML is more clearly described in the following 
references, which are incorporated herein by reference: (1) Martin Fowler, UML 
Distilled Second Edition: Applying the Standard Object Modeling Language . Addison- 
5 Wesley (1999); (2) Booch, Rumbaugh, and Jacobson, The Unified Modeling Language 
User Guide , Addison- Wesley (1998); (3) Peter Coad, Jeff DeLuca, and Eric Lefebvre, 
Java Modeling in Color with UML: Enterprise Components and Process , Prentice Hall 
(1999); and (4) Peter Coad, Mark Mayfield, and Jonathan Kern, Java Design: Building 
Better Apps & Applets (2nd Ed.), Prentice Hall (1998). 

10 As shown in Fig. 1, conventional software development tools 100 allow a 

programmer to view UML 102 while viewing source code 104. The source code 104 is 
stored in a file, and a reverse engineering module 106 converts the source code 104 into 
a representation of the software project in a database or repository 108. The software 
project comprises source code 104 in at least one file which, when compiled, forms a 

15 sequence of instructions to be run by the data processing system. The repository 108 
generates the UML 102. If any changes are made to the UML 102, they are 
automatically reflected in the repository 108, and a code generator 110 converts the 
representation in the repository 108 into source code 104. Such software development 
tools 100, however, do not synchronize the displays of the UML 102 and the source code 

20 104. Rather, the repository 108 stores the representation of the software project while 
the file stores the source code 104. A modification in the UML 102 does not appear in 
the source code 104 unless the code generator 110 re-generates the source code 104 from 
the data in the repository 108. When this occurs, the portion of the source code 104 that 
is not protected from being overwritten is rewritten. Similarly, any modifications made 

25 to the source code 104 do not appear in the UML 102 unless the reverse engineering 
module 106 updates the repository 108. As a result, redundant information is stored in 
the repository 108 and the source code 104. In addition, rather than making incremental 
changes to the source code 104, conventional software development tools 100 rewrite the 
overall source code 104 when modifications are made to the UML 102, resulting in 

30 wasted processing time. This type of manual, large-grained synchronization requires 
either human intervention, or a "batch" style process to try to keep the two views (the 
UML 102 and the source code 104) in sync. Unfortunately, this approach, adopted by 
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many tools, leads to many undesirable side-effects; such as desired changes to the source 
code being overwritten by the tool. A further disadvantage with conventional software 
development tools 100 is that they are designed to only work in a single programming 
language. Thus, a tool 100 that is designed for Java™ programs cannot be utilized to 
develop a program in C++. There is a need in the art for a tool that avoids the limitations 
of these conventional software development tools. 

Summary Of The Invention 

Methods and systems consistent with the present invention provide an improved 
software development tool that overcomes the limitations of conventional software 
development tools. The improved software development tool of the present invention 
allows a developer to simultaneously view a graphical and a textual display of source 
code. The graphical and textual views are synchronized so that a modification in one 
view is automatically reflected in the other view. In addition, the software development 
tool is designed for use with more than one programming language. 

The improved software development tool enables a developer to quickly 
determine the location of an error detected by a verification tool. Not only can the 
developer locate the specific line of source code, but the software development tool also 
displays the graphical representation of the source code corresponding to the message in 
a visually distinctive manner. This assists the developer in debugging the source code by 
allowing the developer to visually determine the location of the error. 

In accordance with methods consistent with the present invention, a method is 
provided in a data processing system for developing source code. The method comprises 
the steps of receiving a message corresponding to a portion of the source code, and 
displaying the graphical representation of the portion of the source code corresponding to 
the message in a visually distinctive manner. 

In accordance with methods consistent with the present invention, a method is 
provided in a data processing system for developing source code. The method comprises 
the steps of detecting an error in the source code, generating a message reflecting the 
error, and displaying the graphical representation of the portion of the source code 
corresponding to the message in a visually distinctive manner. 
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In accordance with articles of manufacture consistent with the present invention, 
a computer-readable medium is provided. The computer-readable medium contains 
instructions for controlling a data processing system to perform a method. The data 
processing system has source code. The method comprises the steps of receiving a 
5 message corresponding to a portion of the source code, and displaying the graphical 
representation of the portion of the source code corresponding to the message in a 
visually distinctive manner. 

In accordance with articles of manufacture consistent with the present invention, 
a computer-readable medium is provided. The computer-readable medium contains 

10 instructions for controlling a data processing system to perform a method. The data 
processing system has source code. The method comprises the steps of detecting an 
error in the source code, generating a message reflecting the error, and displaying the 
graphical representation of the portion of the source code corresponding to the message 
in a visually distinctive manner. 

15 Other systems, methods, features and advantages of the invention will be or will 

become apparent to one with skill in the art upon examination of the following figures 
and detailed description. It is intended that all such additional systems, methods, 
features and advantages be included within this description, be within the scope of the 
invention, and be protected by the accompanying claims. 

20 Brief Description Of The Drawings 

The accompanying drawings, which are incorporated in and constitute a part of 
this specification, illustrate an implementation of the invention and, together with the 
description, serve to explain the advantages and principles of the invention. In the 
drawings, 

25 Fig. 1 depicts a conventional software development tool; 

Fig. 2 depicts an overview of a software development tool in accordance with 
methods and systems consistent with the present invention; 

Fig. 3 depicts a data structure of the language-neutral representation created by 
the software development tool of Fig. 2; 
30 Fig. 4 depicts representative source code; 
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Fig. 5 depicts the data structure of the language-neutral representation of the 
source code of Fig. 4; 

Fig. 6 depicts a data processing system suitable for practicing the present 
invention; 

5 Fig. 7 depicts an architectural overview of the software development tool of 

Fig. 2; 

Fig. 8 depicts a flow diagram of the steps performed by the software development 
tool depicted in Fig. 2; 

Figs. 9A and 9B depict a flow diagram illustrating the update model step of 

10 Fig. 8; 

Fig. 10 depicts a flow diagram of the steps performed by the software 
development tool in Fig. 2 when creating a class; 

Fig. 11 depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays a use case diagram of source code; 
15 Fig. 12 depicts a user interface displayed by the software development tool 

depicted in Fig. 2, where the user interface displays both a class diagram and a textual 
view of source code; 

Fig. 13 depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays a sequence diagram of source code; 
20 Fig. 14 depicts a user interface displayed by the software development tool 

depicted in Fig. 2, where the user interface displays a collaboration diagram of source 
code; 

Fig. 15 depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays a statechart diagram of source code; 
25 Fig. 16 depicts a user interface displayed by the software development tool 

depicted in Fig. 2, where the user interface displays an activity diagram of source code; 

Fig. 17 depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays a component diagram of source 
code; 

30 Fig. 18 depicts a user interface displayed by the software development tool 

depicted in Fig. 2, where the user interface displays a deployment diagram of source 
code; 
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Fig. 19A depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays a list of predefined criteria which the 
software development tool checks in the source code; 

Fig. 19B depicts a user interface displayed by the software development tool 
5 depicted in Fig. 2, where the user interface displays the definition of the criteria which 
the software development tool checks in the source code, and an example of source code 
which does not conform to the criteria; 

Fig. 19C depicts a user interface displayed by the software development tool 
depicted in Fig. 2, where the user interface displays an example of source code which 
10 conforms to the criteria which the software development tool checks in the source code; 

Figs. 20A and B depict a flow diagram of the steps performed by the software 
development tool in Fig. 2 when locating source code related to a message from a 
verification tool; 

Fig. 21 depicts a user interface displayed by the software development tool 
15 depicted in Fig. 2, where the user interface displays a message from a verification tool; 

Fig. 22 depicts the user interface in Fig. 21 illustrating the selection of a message; 

and 

Fig. 23 depicts the user interface in Fig. 22 after the selection of a message. 

Detailed Description Of The Invention 

20 Methods and systems consistent with the present invention provide an improved 

software development tool that creates a graphical representation of source code 
regardless of the programming language in which the code is written. In addition, the 
software development tool simultaneously reflects any modifications to the source code 
to both the display of the graphical representation as well as the textual display of the 

25 source code. 

As depicted in Fig. 2, source code 202 is being displayed in both a graphical form 
204 and a textual form 206. In accordance with methods and systems consistent with the 
present invention, the improved software development tool generates a transient meta 
model (TMM) 200 which stores a language-neutral representation of the source code 
30 202. The graphical 204 and textual 206 representations of the source code 202 are 
generated from the language-neutral representation in the TMM 200. Alternatively, the 
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textual view 206 of the source code may be obtained directly from the source code file. 
Although modifications made on the displays 204 and 206 may appear to modify the 
displays 204 and 206, in actuality all modifications are made directly to the source code 
202 via an incremental code editor (ICE) 208, and the TMM 200 is used to generate the 
5 modifications in both the graphical 204 and the textual 206 views from the modifications 
to the source code 202. 

The improved software development tool provides simultaneous round-trip 
engineering, i.e., the graphical representation 204 is synchronized with the textual 
representation 206. Thus, if a change is made to the source code 202 via the graphical 

10 representation 204, the textual representation 206 is updated automatically. Similarly, if 
a change is made to the source code 202 via the textual representation 206, the graphical 
representation 204 is updated to remain synchronized. There is no repository, no batch 
code generation, and no risk of losing code. 

The data structure 300 of the language-neutral representation is depicted in Fig. 

15 3. The data structure 300 comprises a Source Code Interface (SCI) model 302, an SCI 
package 304, an SCI class 306, and an SCI member 308. The SCI model 302 is the 
source code organized into packages. The SCI model 302 corresponds to a directory for 
a software project being developed by the user, and the SCI package 304 corresponds to 
a subdirectory. The software project comprises the source code in at least one file that is 

20 compiled to form a sequence of instructions to be run by a data processing system. The 
data processing system is discussed in detail below. As is well known in object-oriented 
programming, the class 306 is a category of objects which describes a group of objects 
with similar properties (attributes), common behavior (operations or methods), common 
relationships to other objects, and common semantics. The members 308 comprise 

25 attributes and/or operations. 

For example, the data structure 500 for the source code 400 depicted in Fig. 4 is 
depicted in Fig. 5. Userlnterface 402 is defined as a package 404. Accordingly, 
Userlnterface 402 is contained in SCI package 502. Similarly, Bank 406, which is 
defined as a class 408, is contained in SCI class 504, and Name 410 and Assets 412, 

30 which are defined as attributes (strings 414), are contained in SCI members 506. Since 
these elements are in the same project, all are linked. The data structure 500 also 
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identifies the language in which the source code is written 508, e.g., the Java™ 
programming language. 

Fig. 6 depicts a data processing system 600 suitable for practicing methods and 
systems consistent with the present invention. Data processing system 600 comprises a 
5 memory 602, a secondary storage device 604, an I/O device 606, and a processor 608. 
Memory 602 includes the improved software development tool 610. The software 
development tool 610 is used to develop a software project 612, and create the TMM 200 
in the memory 602. The project 612 is stored in the secondary storage device 604 of the 
data processing system 600. One skilled in the art will recognize that data processing 

10 system 600 may contain additional or different components. 

Although aspects of the present invention are described as being stored in 
memory, one skilled in the art will appreciate that these aspects can also be stored on or 
read from other types of computer-readable media, such as secondary storage devices, 
like hard disks, floppy disks or CD-ROM; a carrier wave from a network, such as 

1 5 Internet; or other forms of RAM or ROM either currently known or later developed. 

Fig. 7 illustrates an architectural overview of the improved software development 
tool 610. The tool 610 comprises a core 700, an open application program interface 
(API) 702, and modules 704. The core 700 includes a parser 706 and an ICE 208. The 
parser 706 converts the source code into the language-neutral representation in the 

20 TMM, and the ICE 208 converts the text from the displays into source code. There are 
three main packages composing the API 702: Integrated Development Environment 
(IDE) 708; Read-Write Interface (RWI) 710; and Source Code Interface (SCI) 712. Each 
package includes corresponding subpackages. As is well known in the art, a package is a 
collection of attributes, notifications, operations, or behaviors that are treated as a single 

25 module or program unit. 

IDE 708 is the API 702 needed to generate custom outputs based on information 
contained in a model. It is a read-only interface, i.e., the user can extract information 
from the model, but not change the model. IDE 708 provides the functionality related to 
the model's representation in IDE 708 and interaction with the user. Each package 

30 composing the IDE group has a description highlighting the areas of applicability of this 
concrete package. 
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RWI 710 enables the user to go deeper into the architecture. Using RWI 710, 
information can be extracted from and written to the models. RWI not only represents 
packages, classes and members, but it may also represent different diagrams (class 
diagrams, use case diagrams, sequence diagrams and others), links, notes, use cases, 
5 actors, states, etc. 

SCI 712 is at the source code level, and allows the user to work with the source 
code almost independently of the language being used. 

The improved software development tool of the present invention is used to 
develop source code in a project. The project comprises a plurality of files and the 
10 source code of a chosen one of the plurality of files is written in a given language. The 
software development tool determines the language of the source code of the chosen file, 
converts the source code from the language into a language-neutral representation, uses 
the language-neutral representation to textually display the source code of the chosen file 
in the language, and uses the language-neutral representation to display a graphical 
15 representation of at least a portion of the project. The source code and the graphical 
representation are displayed simultaneously. 

The improved software development tool of the present invention is also used to 
develop source code. The software development tool receives an indication of a selected 
language for the source code, creates a file to store the source code in the selected 
20 language, converts the source code from the selected language into a language-neutral 
representation, uses the language-neutral representation to display the source code of the 
file, and uses the language-neutral representation to display a graphical representation of 
the file. Again, the source code and the graphical representation are displayed 
simultaneously. 

25 Moreover, if the source code in the file is modified, the modified source code and 

a graphical representation of at least a portion of the modified source code are displayed 
simultaneously. The QA module of the software development tool provides an error 
message if the modification does not conform to predefined or user-defined styles, as 
described above. The modification to the source code may be received by the software 

30 development tool via the programmer editing the source code in the textual pane or the 
graphical pane, or via some other independent software tool that the programmer uses to 
modify the code. The graphical representation of the project may be in Unified 
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Modeling Language; however, one skilled in the art will recognize that other graphical 
representations of the source code may be displayed. Further, although the present 
invention is described and shown using the various views of the UML, one of ordinary 
skill in the art will recognize that other views may be displayed. 
5 Fig. 8 depicts a flow diagram of the steps performed by the software development 

tool to develop a project in accordance with methods and systems consistent with the 
present invention. As previously stated, the project comprises a plurality of files. The 
developer either uses the software development tool to open a file that contains existing 
source code, or to create a file in which the source code will be developed. If the 

10 software development tool is used to open the file, determined in step 800, the software 
development tool initially determines the programming language in which the code is 
written (step 802). The language is identified by the extension of the file, e.g., "Java" 
identifies source code written in the Java™ language, while ".cpp" identifies source code 
written in C++. The software development tool then obtains a template for the current 

15 programming language, i.e., a collection of generalized definitions for the particular 
language that can be used to build the data structure (step 804). For example, the 
templates used to define a new Java™ class contains a default name, e.g., "Classl," and 
the default code, "public class Class 1 {}." Such templates are well known in the art. For 
example, the "Microsoft Foundation Class Library" and the "Microsoft Word Template 

20 For Business Use Case Modeling" are examples of standard template libraries from 
which programmers can choose individual template classes. The software development 
tool uses the template to parse the source code (step 806), and create the data structure 
(step 808). After creating the data structure or if there is no existing code, the software 
development tool awaits an event, i.e., a modification or addition to the source code by 

25 the developer (step 810). If an event is received and the event is to close the file (step 
812), the file is saved (step 814) and closed (step 816). Otherwise, the software 
development tool performs the event (step 818), i.e., the tool makes the modification. 
The software development tool then updates the TMM or model (step 820), as discussed 
in detail below, and updates both the graphical and the textual views (step 822). 

30 Figs. 9A and 9B depict a flow diagram illustrating the update model step of 

Fig. 8. The software development tool selects a file from the project (step 900), and 
determines whether the file is new (step 902), whether the file has been updated (step 
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904), or whether the file has been deleted (step 906). If the file is new, the software 
development tool adds the additional symbols from the file to the TMM (step 908). To 
add the symbol to the TMM, the software development tool uses the template to parse 
the symbol to the TMM. If the file has been updated, the software development tool 
5 updates the symbols in the TMM (step 910). Similar to the addition of a symbol to the 
TMM, the software development tool uses the template to parse the symbol to the TMM. 
If the file has been deleted, the software development tool deletes the symbols in the 
TMM (step 912). The software development tool continues this analysis for all files in 
the project. After all files are analyzed (step 914), any obsolete symbols in the TMM 

1 0 (step 9 1 6) are deleted (step 918). 

Fig. 10 depicts a flow diagram illustrating the performance of an event, 
specifically the creation of a class, in accordance with methods and systems consistent 
with the present invention. After identifying the programming language (step 1000), the 
software development tool obtains a template for the language (step 1002), creates a 

15 source code file in the project directory (step 1004), and pastes the template onto the 
TMM (step 1006). The project directory corresponds to the SCI model 302 of Fig. 3. 
Additional events which a developer may perform using the software development tool 
include the creation, modification or deletion of packages, projects, attributes, interfaces, 
links, operations, and the closing of a file. 

20 Applications to be developed using the software development tool are 

collectively broken into three views of the application: the static view, the dynamic 
view, and the functional view. The static view is modeled using the use-case and class 
diagrams. A use case diagram 1100, depicted in Fig. 11, shows the relationship among 
actors 1 102 and use cases 1 104 within the system 1 106. A class diagram 1200, depicted 

25 in Fig. 12 with its associated source code 1202, on the other hand, includes classes 1204, 
interfaces, packages and their relationships connected as a graph to each other and to 
their contents. 

The dynamic view is modeled using the sequence, collaboration and statechart 
diagrams. As depicted in Fig. 13, a sequence diagram 1300 represents an interaction, 
30 which is a set of messages 1302 exchanged among objects 1304 within a collaboration to 
effect a desired operation or result. In a sequence diagram 1300, the vertical dimension 
represents time and the horizontal dimension represents different objects. A 
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collaboration diagram 1500, depicted in Fig. 15 5 is also an interaction with messages 
1502 exchanged among objects 1504, but it is also a collaboration, which is a set of 
objects 1504 related in a particular context. Contrary to sequence diagrams 1300 (Fig. 
13), which emphasize the time ordering of messages along the vertical axis, 
5 collaboration diagrams 1400 (Fig. 14) emphasize the structural organization of objects. 

A statechart diagram 1500 is depicted in Fig. 15. The statechart diagram 1500 
includes the sequences of states 1502 that an object or interaction goes through during its 
life in response to stimuli, together with its responses and actions. It uses a graphic 
notation that shows states of an object, the events that cause a transition from one state to 

10 another, and the actions that result from the transition. 

The functional view can be represented by activity diagrams 1600 and more 
traditional descriptive narratives such as pseudocode and minispecifications. An activity 
diagram 1600 is depicted in Fig. 16, and is a special case of a state diagram where most, 
if not all, of the states are action states 1602 and where most, if not all, of the transitions 

15 are triggered by completion of the actions in the source states. Activity diagrams 1600 
are used in situations where all or most of the events represent the completion of 
internally generated actions. 

There is also a fourth view mingled with the static view called the architectural 
view. This view is modeled using package, component and deployment diagrams. 

20 Package diagrams show packages of classes and the dependencies among them. 
Component diagrams 1700, depicted in Fig. 17, are graphical representations of a system 
or its component parts. Component diagrams 1700 show the dependencies among 
software components, including source code components, binary code components and 
executable components. As depicted in Fig. 18, Deployment diagrams 1800 are used to 

25 show the distribution strategy for a distributed object system. Deployment diagrams 
1800 show the configuration of run-time processing elements and the software 
components, processes and objects that live on them. 

Although discussed in terms of class diagrams, one skilled in the art will 
recognize that the software development tool of the present invention may support these 

30 and other graphical views. 
Quality Assurance Module 
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There are a variety of modules 704 in the software development tool 610 of the 
present invention. Some of the modules 704 access information to generate graphical 
and code documentation in custom formats, export to different file formats, or develop 
patterns. The software development tool also includes a quality assurance (QA) module 
5 which monitors the modifications to the source code and calculates various complexity 
metrics, i.e., various measurements of the program's performance or efficiency, to 
support quality assurance. The types of metrics calculated by the software development 
tool include basic metrics, cohesion metrics, complexity metrics, coupling metrics, 
Halstead metrics, inheritance metrics, maximum metrics, polymorphism metrics, and 
10 ratio metrics. Examples of these metrics with their respective definitions are identified 
in Tables 1-9 below. 



Table 1 - Basic Metrics 



Basic Metrics 


Description 


Lines Of Code 


Counts the number of code lines. The user determines whether to 
include comments and blank lines. 


Number Of Attributes 


Counts the number of attributes. The user determines whether to 
include inherited attributes. Inherited attributes may be counted. 
If a class has a high number of attributes, it may be appropriate to 
divide it into subclasses. 


Number Of Classes 


Counts the number of classes. 


Number of 
Constructors 


Counts the number of constructors. The user determines whether 
to include all constructors, or to limit the count to public 
constructors, protected constructors, etc. 


Number Of Import 
Statements 


Counts the number of imported packages/classes. This measure 
can highlight excessive importing, and also can be used as a 
measure of coupling. 


Number Of Members 


Counts the number of members, i.e., attributes and operations. 
The user determines whether to include inherited members. If a 
class has a high number of members, it may be appropriate to 
divide it into subclasses. 


Number Of Operations 


Counts the number of operations. The user determines whether to 
include inherited operations. If a class has a high number of 
operations, it may be appropriate to divide it into subclasses. 
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Table 2 - Cohesion Metrics 



Cohesion Metrics 


Description 


Lack Of Cohesion Of 
Methods 1 


Takes each pair of methods in a class and determines a set of 
fields accessed by each of them. If the pair has disjoint sets of 
field accesses, the value for P is incremented by one. If the pair 
shares at least one field access, then the value for Q is 
incremented by one. After considering each pair of methods: 

RESULT = (P>Q) ? (P - Q) : 0 

A low value indicates high coupling between methods, which 
indicates potentially low reusability and increased testing because 
many methods can affect the same attributes. 


Lack Of Cohesion Of 
Methods 2 


Counts the percentage of methods that do not access a specific 
attribute averaged over all attributes in the class. A high value of 
cohesion (a low lack of cohesion) implies that the class is well 
designed. A cohesive class will tend to provide a high degree of 
encapsulation, whereas a lack of cohesion decreases 
encapsulation and increases complexity. 


Lack Of Cohesion Of 
Methods 3 


Measures the dissimilarity of methods in a class by attributes. 

If m = number of methods in a class 
a = number of attributes in a class 
mA = number of methods that access an attribute 
EmA = sum of mA for each attribute 

Then RESULT = 100 * (EmA / a-m) / (1 -m) 

A low value indicates good class subdivision, which implies 
simplicity and high reusability. A high lack of cohesion increases 
complexity, thereby increasing the likelihood of errors during the 
development process. 
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Table 3 - Complexity Metrics 



Complexity Metrics 



Description 


Defined as the sum of each attribute's value in the class. 


The 


value is evaluated as: 










boolean 




Void 


3 


Long 


3 


byte 




Boolean 


3 


Number 


3 


char 




Byte 


3 


Float 


3 


short 




Character 


3 


Double 


3 


int 




String 


3 


array 


3 


long 




StringBuffer 


3 


j ava. lang.* 


5 


float 


2 


Short 


3 


Vector 


7 


double 


2 


Integer 


3 


others 


9 



Attribute Complexity 



Cyclomatic 
Complexity 



Represents the cognitive complexity of the class. It counts the 
number of possible paths through an algorithm by counting the 
number of distinct regions on a flowgraph, i.e., the number of 'if,' 
'for 5 and 'while' statements in the operation's body. The user 
determines whether to include case labels of switch statement. 



Number Of Remote 
Methods 



Processes all of the methods and constructors, and counts the 
number of different remote methods called. A remote method is 
defined as a method which is not declared in either the class itself 
or its ancestors. 



Response For Class 



Calculated as 'Number of Local Methods' + 'Number of Remote 
Methods.' The size of the response set for the class includes 
methods in the class' inheritance hierarchy and methods that can 
be invoked on other objects. A class which provides a larger 
response set is considered to be more complex and requires more 
testing than one with a smaller overall design complexity. 



Weighted Methods Per 
Class 1 



The sum of the complexity of all methods for a class, where each 
method is weighted by its cyclomatic complexity. The number of 
methods and the complexity of the methods involved is a 
predictor of how much time and effort is required to develop and 
maintain the class. Methods specified in a class are included, i.e., 
methods inherited from a parent are excluded. 



Weighted Methods Per 
Class 2 



Measures the complexity of a class, assuming that a class with 
more methods than another is more complex, and that a method 
with more parameters than another is also likely to be more 
complex. Methods specified in a class are included, i.e., methods 
inherited from a parent are excluded. 
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Table 4 - Coupling Metrics 



Coupling Metrics 


Description 


Coupling Between 
Objects 


Represents the number of other classes to which a class is 
coupled. Counts the number of reference types that are used in 
attribute declarations, formal parameters, return types, throws 
declarations and local variables, and types from which attribute 
and method selections are made. Primitive types, types from 
java.lang package, and supertypes are not counted. 

Excessive coupling between objects is detrimental to modular 
design and prevents reuse. The more independent a class is, the 
easier it is to reuse it in another application. In order to improve 
modularity and promote encapsulation, inter-object class couples 
should be kept to a minimum. The larger the number of couples, 
the higher the sensitivity to changes in other parts of the design, 
and therefore maintenance is more difficult. A measure ot 
coupling is useful to determine how complex the testing of 
various parts of a design is likely to be. The higher the inter- 
object class coupling, the more rigorous the testing needs to be. 


Coupling Factor 


The fraction having the number of non- inheritance couplings as a 
numerator and the maximum possible number of couplings in a 
system as a denominator. This measure is from the Metrics for 
ODject-unenteG. ueveiopment suite. 


Data Abstraction 
Coupling 


Counts the number of reference types used in the attribute 
declarations. Primitive types, types from java.lang package and 
super types are not counted. 


FanOut 


Counts the number of reference types that are used in attribute 
declarations, formal parameters, return types, throws declarations, 
and local variables. Simple types and super types are not 
counted. 
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Table 5 - Halstead Metrics 



Halstead Metrics 


Description 

Mr 


Halstead Difficulty 


This measure is one of the Halstead Software Science metrics. It 
is calculated as ( Number of Unique Operators / Number of 
Unique Operands') * ('Number of Operands' / 'Number of 
Unique Operands'). 


Halstead Effort 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Halstead Difficulty' * 'Halstead Program 
Volume.' 


Halstead Program 
Length 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Number of Operators' + 'Number of Operands.' 


Halstead Program 
Vocabulary 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Number of Unique Operators' + 'Number of 
Unique Operands.' 


Halstead Program 
Volume 


This measure is one of the Halstead Software Science metrics. It 
is calculated as Halstead Program Length * Log2( Halstead 
Program Vocabulary'). 


Number Of Operands 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of operands used in a class. 


Number Of Operators 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of operators used in a class. 


Number Of Unique 
Operands 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of unique operands used in a class. 


Number Of Unique 
Operators 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of unique operators used in a class. 


Table 6 - Incapsulation Metrics 


Incapsulation Metrics 


Description 


Attribute Hiding Factor 


The fraction having the sum of the invisibilities of all attributes 
defined in all classes as a numerator, and the total number of 
attributes defined in the project as a denominator. The 
invisibility of an attribute is the percentage of the total classes 
from which this attribute is not visible. This measure is from the 
Metrics for Object-Oriented Development suite. 


Method Hiding Factor 


The fraction having the sum of the invisibilities of all methods 
defined in all classes as a numerator, and the total number of 
methods defined in the project as a denominator. The 
invisibility of a method is the percentage of the total classes 
from which this method is not visible. This measure is from the 
Metrics for Object-Oriented Development suite. 
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Table 7 - Inheritance Metrics 



Inheritance Metrics 


Description 


Attribute Inheritance 
Factor 


The fraction having the sum of inherited attributes in all classes in 
the project as a numerator, and the total number of available 
attributes (locally defined plus inherited) for all classes as a 
denominator. This measure is from the Metrics for Object- 
Oriented Development suite. 


Depth Of Inheritance 
Hierarchy 


Counts how far down the inheritance hierarchy a class or 
interface is declared. High values imply that a class is quite 
specialized. 


Method Inheritance 
Factor 


The fraction having the sum of inherited methods in all classes in 
the project as a numerator, and the total number of available 
methods (locally defined plus inherited) for all classes as a 
denominator. This measure is from the Metrics for Object- 
Oriented Development suite. 


Number Of Child 
Classes 


Counts the number of classes which inherit from a particular 
class, i.e., the number of classes in the inheritance tree down from 
a class. A non-zero value indicates that the particular class is 
being re-used. The abstraction of the class may be poor if there 
are too many child classes. A high value of this measure points 
to the definite amount of testing required for each child class. 


Table 8 - Maximum Metrics 


Maximum Metrics 


Description 


Maximum Number Of 
Levels 


Counts the maximum depth of 'if,' 'for' and 'while' branches in 
the bodies of methods. Logical units with a large number of 
nested levels may need implementation simplification and 
process improvement because groups that contain more than 
seven pieces of information are increasingly harder for people to 
understand in problem solving. 


Maximum Number Of 
Parameters 


Displays the maximum number of parameters among all class 
operations. Methods with many parameters tend to be more 
specialized and, thus, are less likely to be reusable. 


Maximum Size Of 
Operation 


Counts the maximum size of the operations for a class. Method 
size is determined in terms of cyclomatic complexity, i.e., the 
number of 'if,' 'for' and 'while' statements in the body of the 
operation. The user determines whether to include case labels of 
switch statement. 
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Table 9 - Polymorphism Metrics 



Polymorphism 
Metrics 


Description 


Number Of Added 
Methods 


Counts the number of operations added by a class. Inherited and 
overridden operations are not counted. Classes without parents 
are not processed. A large value of this measure indicates that the 
functionality of the given class becomes increasingly distinct 
from that of the parent classes. In this case, it should be 

•i 11 ,1 ,i ■ i 1 1 J 1 * 1 *x" J? 

considered whether this class genuinely should be inheriting from 
the parent, or if it could be broken down into several smaller 
classes. 


Number Of 
Overridden Methods 


Counts the number of inherited operations which a class 
overrides. Classes without parents are not processed. High 
values tend to indicate design problems, i.e., subclasses should 
generally add to and extend the functionality of the parent classes 
rather than overriding them. 


Polymorphism Factor 


This measure is from the Metrics for Object-Oriented 
Development suite, and is calculated as a fraction. 

The numerator is the sum of the overriding methods in all classes. 
This is the actual number of possible different polymorphic 
situations. A given message sent to a class can be bound, 
statically or dynamically, to a named method implementation. 
The latter can have as many shapes (morphos) as the number of 

, ■ . ■» • j 1 1 ■ '11 * j 1 j 1 ^ 1 1 j 

times this same method is overridden m that class descendants. 

The denominator represents the maximum number of possible 
distinct polymorphic situations for that class as the sum for each 
class of the number of new methods multiplied by the number of 
descendants. This maximum would be the case where all new 
methods defined in each class would be overridden in all of their 
derived classes.. 
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Table 10 - Ratio Metrics 



Ratio Metrics 


Description 


Comment Ratio 


Counts the ratio of comments to total lines of code including 
comments. The user determines whether to include blank lines as 
part of the total lines of code. 


Percentage Of Package 
Members 


Counts the percentage of package members in a class. 


Percentage Of Private 
Members 


Counts the percentage of private members in a class. 


Percentage Of 
Protected Members 


Counts the percentage of protected members in a class. 


Percentage Of Public 
Members 


Counts the proportion of vulnerable members in a class. A large 
proportion of such members means that the class has high 
potential to be affected by external classes and means that 
increased efforts will be needed to test such a class thoroughly. 


True Comment Ratio 


Counts the ratio of comments to total lines of code excluding 
comments. The user determines whether to include blank lines as 
part of the total lines of code. 



The QA module also provides audits, i.e., the module checks for conformance to 
predefined or user-defined styles. The types of audits provided by the module include 
coding style, critical errors, declaration style, documentation, naming style, performance, 
5 possible errors and superfluous content. Examples of these audits with their respective 
definitions are identified in Tables 10-17 below. 
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Table 1 1 - Coding Style Audits 



Coding Style Audits 


Description 


Avoid Complex 
Initialization or 
Update Clause in For 
Loops 


When using the comma operator in the initialization or update 
clause of a for statement, avoid the complexity of using more 
than three variables. 


Avoid Implementation 
Packages Referencing 


This rule helps you avoid referencing packages that normally 
should not be referenced. 


Access Of Static 
Members Through 
Objects 


Static members should be referenced through class names rather 
than through objects. 


Assignment To Formal 
Parameters 


Formal parameters should not be assigned. 


Avoid Too Long Files 


According to Sun Code Conventions for Java, files longer than 
2000 lines are cumbersome and should be avoided. 


Avoid Too Long Lines 


According to Sun Code Conventions for Java, lines longer than 
80 characters should be avoided, since they're not handled well 
by many terminals and tools. 


Complex Assignment 


Checks for the occurrence of multiple assignments and 
assignments to variables within the same expression. Complex 
assignments should be avoided since they decrease program 
readability. 


Don't Code Numerical 
Constants Directly 


According to Sun Code Conventions for Java, numerical 
constants (literals) should not be coded directly, except for -1, 0, 
and 1, which can appear in a for loop as counter values. 


Don't Place Multiple 
Statements on the 
Same Line 


According to Sun Code Conventions for Java, each line should 
contain at most one statement. 


Don't Use the 
Negation Operator 
Frequently 


The negation operator slows down the readability of the program. 
Thus, it is recommended that it not be used frequently. 


Operator'?:' May Not 
Be Used 


The operator '?:' makes the code harder to read than the 
alternative form with an if-statement. 


Parenthesize 
Conditional Part of 
Ternary Conditional 
Expression 


According to Sun Code Conventions for Java, if an expression 
containing a binary operator appears before the ? in the ternary ?: 
operator, it should be parenthesized. 


Put Declarations Only 
at the Beginning of 
Blocks 


Sun Code Conventions for Java recommends to put declarations 
only at the beginning of blocks. (A block is any code surrounded 
by curly braces "{" and "}".) Don't wait to declare variables until 
their first use; it can confuse the unwary programmer and hamper 
code portability within the scope. 


Provide Incremental In 
For-Statement or use 
while-statement 


Checks if the third argument of the 'for' -statement is missing. 


Replacement For 


Demand import-declarations must be replaced by a list of single 
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Demand Imports 


import-declarations that are actually imported into the 
compilation unit. In other words, import-statements may not end 
with an asterisk. 


Switch Statement 
Should Include a 
Default Case 


According to Sun Code Conventions for Java, every switch 
statement should include a default case. 


Use Abbreviated 
Assignment Operator 


Use the abbreviated assignment operator in order to write 
programs more rapidly. Also some compilers run faster with the 
abbreviated assignment operator. 


Use 'this' Explicitly 
To Access Class 
Members 


Tries to make the developer use 'this' explicitly when trying to 
access class members. Using the same class member names with 
parameter names often makes what the developer is referring to 
unclear. 
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Table 12 - Critical Errors Audits 



Critical Errors 
Audits 


Description 


Avoid Hiding 
Inherited Attributes 


Detects when attributes declared in child classes hide inherited 
attributes. 


Avoid Hiding 
Inherited Static 
Methods 


Detects when inherited static operations are hidden by child 
classes. 


Command Query 
Separation 


Prevents methods that return a value from a modifying state. The 
methods used to query the state of an object must be different 
from the methods used to perform commands (change the state of 
the object). 


Hiding Of Names 


Declarations of names should not hide other declarations of the 
same name. 


Inaccessible 
Constructor Or 
Method Matches 


Overload resolution only considers constructors and methods that 
are visible at the point of the call. If, however, all the 
constructors and methods were considered, there may be more 
matches. This rule is violated in this case. 

Imagine that ClassB is in a different package than ClassA. Then 
the allocation of ClassB violates this rule since the second 
constructor is not visible at the point of the allocation, but it still 
matches the allocation (based on signature). Also the call to open 
in ClassB violates this rule since the second and the third 
declarations of open are not visible at the point of the call, but it 
still matches the call (based on signature). 


Multiple Visible 
Declarations With 
Same Name 


Multiple declarations with the same name must not be 
simultaneously visible except for overloaded methods. 


Overriding a Non- 
Abstract Method With 
an Abstract Method 


Checks for abstract methods overriding non-abstract methods in a 
subclass. 


Overriding a Private 
Method 


A subclass should not contain a method with the same name and 
signature as in a superclass if these methods are declared to be 
private. 


Overloading Within a 
Subclass 


A superclass method may not be overloaded within a subclass 
unless all overloading in the superclass are also overridden in the 
subclass. It is very unusual for a subclass to be overloading 
methods in its superclass without also overriding the methods it is 
overloading. More frequently this happens due to inconsistent 
changes between the superclass and subclass - i.e., the intention 
of the user is to override the method in the superclass, but due to 
the error, the subclass method ends up overloading the superclass 
method. 


Use of Static Attribute 
for Initialization 


Non-final static attributes should not be used in initializations of 
attributes. 
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Table 13 - Declaration Style Audits 



Declaration Style 
Audits 


Description 


Badly Located Array 
Declarators 


Array declarators must be placed next to the type descriptor of 
their component type. 


Constant Private 
Attributes Must Be 
Final 


Private attributes that never get their values changed must be 
declared final. By explicitly declaring them in such a way, a 
reader of the source code get some information of how the 
attribute is supposed to be used. 


Constant Variables 
Must Be Final 


Local variables that never get their values changed must be 
declared final. By explicitly declaring them in such a way, a 
reader of the source code obtains information about how the 
variable is supposed to be used. 


Declare Variables In 
One Statement Each 


Several variables (attributes and local variables) should not be 
declared in the same statement. 


Instantiated Classes 
Should Be Final 


This rule recommends making all instantiated classes final. It 
checks classes which are present in the object model. Classes 
from search/classpath are ignored. 


List All Public And 
Package Members 
First 


Enforces a standard to improve readability. Methods/data in your 
class should be ordered properly. 


Order of Class 
Members Declaration 


According to Sun Code Conventions for Java, the parts of a class 
or interface declaration should appear in the following order 

1. Class (static) variables. First the public class variables, 
then the protected, then package level (no access 
modifier), and then the private. 

2. Instance variables. First the public class variables, then 
the protected, then package level (no access modifier), 
and then the private. 

3. Constructors 

4. Methods 


Order Of Appearance 
Of Modifiers 


Checks for correct ordering of modifiers. For classes, this 
includes visibility (public, protected or private), abstract, static, 
final. For attributes, this includes visibility (public, protected or 
private), static, final, transient, volatile. For operations, this 
includes visibility (public, protected or private), abstract, static, 
final, synchronized, native. 


Put the Main Function 
Last 


Tries to make the program comply with various coding standards 
regarding the form of the class definitions. 


Place Public Class 
First 


According to Sun Code Conventions for Java, the public class or 
interface should be the first class or interface in the file. 
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Table 14 -Documentation Audits 



Docu mentation 
Audits 


Description 


Bad Tag In JavaDoc 
Comments 


This rule verifies code against accidental use of improper 
JavaDoc tags. 


Distinguish Between 
JavaDoc And Ordinary 
Comments 


Checks whether the JavaDoc comments in your program ends 
with '**/' and ordinary C-style ones with '*/.' 


Provide File 
Comments 


According to Sun Code Conventions for Java, all source files 
should begin with a c-style comment that lists the class name, 
version information, date, and copyright notice. 


Provide JavaDoc 
Comments 


Checks whether JavaDoc comments are provided for classes, 
interfaces, methods and attributes. Options allow to specify 
whether to check JavaDoc comments for public, package, 
protected or all classes and members. 


Table 15 - Naming Style Audits 


Naming Style Audits 


Description 


Class Name Must 
Match Its File Name 


Checks whether top level classes or interfaces have the same 
name as the file in which they reside. 


Group Operations 
With Same Name 
Together 


Enforces standard to improve readability. 


Naming Conventions 


Takes a regular expression and item name and reports all 
occurrences where the pattern does not match the declaration. 


Names Of Exception 
Classes 


Names of classes which inherit from Exception should end with 
Exception. 


Use Conventional 
Variable Names 


One-character local variable or parameter names should be 
avoided, except for temporary and looping variables, or where a 
variable holds an undistinguished value of a type. 


Table 16 - Performance Audits 


Performance Audits 


Description 


Avoid Declaring 
Variables Inside Loops 


This rule recommends declaring local variables outside the loops 
since declaring variables inside the loop is less efficient. 


Append To String 
Within a Loop 


Performance enhancements can be obtained by replacing String 
operations with StringBuffer operations if a String object is 
appended within a loop. 


Complex Loop 
Expressions 


Avoid using complex expressions as repeat conditions within 
loops. 
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Table 17 - Possible Error Audits 



Possible Error Audits 


Description 


Avoid Empty Catch 
Blocks 


Catch blocks should not be empty. Programmers frequently forget 
to process negative outcomes of a program and tend to focus 
more on the positive outcomes. 

When 'Check parameter usage* option is on, this rule also checks, 
whether code does something with the exception parameter or 
not. If not, violation is raised. 

You can also specify the list of exceptions, which should be 
ignored. For example, for PropertyVetoException catch block 
usually is empty - as a rule, the program just does nothing if this 
exception occurs. 


Avoid Public And 
Package Attributes 


Declare the attributes either private or protected, and provide 
operations to access or change them. 


Avoid Statements 
With Empty Body 


If a statement with an empty body exists m the code, the software 
development tool will display this error message when an audit is 
performed. 


Assignment To For- 
Loop Variables 


'For'-loop variables should not be assigned. 


Don't Compare 
Floating Point Types 


Avoid testing for equality of floating point numbers since 
floating-point numbers that should be equal are not always equal 
due to rounding problems. 


Enclosing Body 
Within a Block 


The statement of a loop must always be a block. The 'then' and 
'else' parts of 'if -statements must always be blocks. This makes 
it easier to add statements without accidentally introducing bugs 
in case the developer forgets to add braces. 


Explicitly Initialize All 
Variables 


Explicitly initialize all variables. The only reason not to initialize 
a variable is where it's declared is if the initial value depends on 
some computation occurring first. 


Method finalize() 
Doesn't Call 
super. finalizeO 


Calling of super. fmalize() from finalize() is good practice of 
programming, even if the base class doesn't define the finalize() 
method. This makes class implementations less dependent on 
each other. 


Mixing Logical 
Operators Without 
Parentheses 


An expression containing multiple logical operators should be 
parenthesized properly. 


No Assignments In 

Conditional 

Expressions 


Use of assignment within conditions makes the source code hard 
to understand. 


Supply Break or 
Comment in Case 
Statement 


According to Sun Code Conventions for Java, every time a case 
falls through (doesn't include a break statement), a comment 
should be added where the break statement would normally be. 
The break in the default case is redundant, but it prevents a fall- 
through error if later another case is added. 


Use 'equals' Instead 


The operator used on strings checks if two string objects are 



11259732vl -27- 



Possible Error Audits 


Description 


Of '==' 


two identical objects. In most situations, however, one likes to 
simply check if two strings have the same value. In these cases, 
the 'equals' method should be used. 


Use 'L' Instead Of T 
at the end of integer 
constant 


It is better to use uppercase 'L' to distinguish the letter T from 
the number '1.' Thus, if a lowercase "1" is used, the software 
development tool will display this error message when an audit is 
performed. 


Use Of the 

'synchronized' 

Modifier 


The 'synchronized' modifier on methods can sometimes cause 
confusion during maintenance as well as during debugging. This 
rule therefore recommends against using this modifier, and 
instead recommends using 'synchronized' statements as 
replacements. 
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Table 18 - Superfluous Content Audits 



Superfluous Content 
Audits 


Description 


Duplicate Import 
Declarations 


There should be at most one import declaration that imports a 
particular class/package. 


Don't Import the 
Package the Source 
File Belongs To 


No classes or interfaces need to be imported from the package to 
which the source code file belongs. Everything in that package is 
available without explicit import statements. 


Explicit Import Of the 
java.lang Classes 


If the code calls for explicit import of classes from the package 
'java.lang/ the software development tool will display this error 
message when an audit is performed. 


Equality Operations 
On Boolean 
Arguments 


Avoid performing equality operations on Boolean operands. 
'True' and 'false' literals should not be used in conditional 
clauses. 


T a. J Ti. "fc 4- j 

Imported Items Must 
Be Used 


It is not legal to import a class or an interface and never use it. 
This rule checks classes and interfaces that are explicitly 
imported with their names — that is not with import of a complete 
package, using an asterisk. If unused class and interface imports 
are omitted, the amount of meaningless source code is reduced - 
thus the amount of code to be understood by a reader is 
minimized. 


Unnecessary Casts 


Checks for the use of type casts that are not necessary. 


Unnecessary 

'instanceof 

Evaluations 


Verifies that the runtime type of the left-hand side expression is 
the same as the one specified on the right-hand side. 


Unused Local 
Variables And Formal 
Parameters 


Local vanables and formal parameter declarations must be used. 


t t__ Af nu««i«+« 

Use Ot Obsolete 
Interface Modifier 


The modifier abstract is considered obsolete and should not be 
used. 


Use Of Unnecessary 
mieridce iviemoer 
Modifiers 


All interface operations are implicitly public and abstract. All 
interface attributes are implicitly public, final and static. 


Unused Private Class 
Member 


An unused class member might indicate a logical flaw in the 
program. The class declaration has to be reconsidered in order to 
determine the need of the unused member(s). 


Unnecessary Return 
Statement Parentheses 


According to Sun Code Conventions for Java, a return statement 
with a value should not use parentheses unless they make the 
return value more obvious in some way. 



If the QA module determines that the source code does not conform to the audit 
and/or the metrics requirements, an error message is provided to the developer. The 
audit and metrics requirements are well known in software development. For example, 
5 as depicted in Fig. 19A, the software development tool checks for a variety of coding 
styles 1900. If the software development tool were to check for "Access Of Static 
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Members Through Objects" 1902, it would verify whether static members are referenced 
through class names rather than through objects 1904. Further, as depicted in Fig. 19B, 
if the software development tool were to check for "Complex Assignment" 1906, the 
software development tool would check for the occurrence of multiple assignments and 
5 assignments to variables within the same expression to avoid complex assignments since 
these decrease program readability 1908. An example of source code 1910 having a 
complex assignment is depicted in Fig. 19B, and the corresponding source code 1912 
having a non-complex assignment is depicted in Fig. 19C. For example, the complex 
assignment: 

10 i*=j++ 

in the source code 1910 in Fig. 19B can be represented in a non-complex form as 
follows: 

J++ 
i *=j 

15 Both the complex and the non-complex formulas perform the same operations, i.e., add 1 
to j and multiply j with i. If the complex assignment identified in the source code 1910 
in Fig. 19B is used, the software development tool will generate the "Complex 
Assignment" error message when an audit is performed. If, on the other hand, the non- 
complex assignment identified in the source code 1912 in Fig. 19C is used, the software 

20 development tool will not generate the "Complex Assignment" error message when an 
audit is performed. 

An example for each of the audits identified above in Tables 1 1 - 1 8 is provided 

below: 

Coding Style 

25 Avoid Complex Initialization or Update Clause in For Loops 

When using the comma operator in the initialization or update clause of a for 
statement, the developer should avoid the complexity of using more than three variables. 
The following source code illustrates the use of more than three variables in a "for 
statement": 
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for ( i = 0, j=0, k=10, 1=-1 ; i < cnt; 
i++,j++,k--,l+=2 ) { 
// do something 

} 

5 To remedy the complexity of using more than three variables, the source code may be 
rewritten as follows: 

1-1; 

for ( i = 0, j=0, k=10; i < cnt; 
i++,j++> k~) { 

10 //do something 

l+=2; 

} 

Avoid Implementation Packages Referencing 

This rule helps a developer avoid referencing packages that normally should not 
15 be referenced. For example, if the developer uses Facade or AbstractFactory patterns, he 
or she can make sure that no one uses direct calls to the underlying constructors of the 
classes. 

The developer can divide his or her packages into interface and implementation 

packages, and ensure that no one ever refers to the implementation packages, while the 

20 interface packages are accessible for reference. The developer can set up two lists of 

packages: the allowed (interface) and banned (implementation) packages. For each 

class reference in source code, this rule verifies that the package where this class belongs 

is in the allowed list and not in the banned list. 

Package names in the list may be: 

25 - any package is allowed or banned 

package name - this package is allowed or banned 

package name postfixed by '*' -any subpackage of the given 

package is allowed or banned 

In case of conflict, the narrower rule prevails. For example, if the following list 

30 is specifically allowed: 
* 

com.mycompany.openapi.* 
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and the following is banned: 

com.mycompany.* 

In the above example, all subpackages of com.mycompany package are banned except 
for those belonging to: 
5 com.mycompany. openapi subpackage. 

Access Of Static Members Through Objects 

Static members should be referenced through class names rather than through 
objects. For example, the following code is incorrect: 
class AOSMTOl { 
10 void func () { 

AOSMTOl objl =new AOSMT01(); 
AOSMT02 obj2 = new AOSMT02(); 
objl.attr = 10; 
obj2.attr = 20; 
15 objl.oper(); 

obj2.oper(); 

this.attr++; 

this.oper(); 

} 

20 static int attr; 

static void oper () {} 

class AOSMT02 { 
static int attr; 
25 static void oper 0 {} 

} 

The following source code corrects the above code so that the static members are 
referenced via class names: 

class AOSMTOl { 
30 void func () { 

AOSMTOl objl = new AOSMTOl (); 
AOSMT02 obj2 = new AOSMT02Q; 
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AOSMTOLattr= 10; 
AOSMT02.attr = 20; 
AOSMTOLoper(); 
AOSMT02.oper(); 
5 AOSMTOLattr++; 

AOSMTOLoper(); 

} 

static int attr; 
static void oper () {} 

10 } 

class AOSMT02 { 
static int attr; 
static void oper () {} 

} 

15 Assignment To Formal Parameters 

Formal parameters should not be assigned values. For example, the following 
code increments param by 1 1, and returns the new value for param: 
int oper (int param) { 
param += 10; 
20 return ++param; 

} 

Rather than reassigning the value for param, the following code declares a new variable 
result, sets result to equal param +11, and returns the value for result: 
int oper (int param) { 
25 int result = param +10; 

return ++result; 

} 

Avoid Too Long Files 

Files longer than 2000 lines are cumbersome and should be avoided. 
30 Avoid Too Long Lines 

Lines longer than 80 characters should be avoided, since they are not handled 
well by many terminals and tools. 
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Complex Assignment 

This audit checks for the occurrence of multiple assignments and assignments to 
variables within the same expression. Complex assignments should be avoided since 
they decrease program readability. 
5 If the 'strict' option is off, assignments of equal value to several variables in one 

operation are permitted. For example the following statement would raise violation if 
'strict' option were on; otherwise there would be no violation: 
i=j=k = 0; 

The following source code is an example of a compound assignment, which should be 
10 avoided: 

i *=j++; 
k=j = 10; 
l=j+=15; 

The following source code is an example of a nested assignment, which should be 
15 avoided: 

i=j++ + 20; 
i = (j = 25) + 30; 

The source code shown above is corrected by breaking the statements into several 
statements. For example, the following source code: 

20 i*=j++; 

may be replaced by: 
i * = j 

The following code: 
25 k=j-10; 
may be replaced by: 
k= 10; 
j = 10; 
The following code: 
30 I=j+=15; 
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may be replaced by: 

j+=15; 

The following code: 
5 i=j++ + 20; 

may be replaced by: 

i=j+20; 
The following source code: 
10 i = 0 = 25) + 30; 

may be replaced by: 

j = 25; 

i=j + 30; 

Don't Code Numerical Constants Directly 
15 Numerical constants (literals) should not be coded directly, except for -1, 0, and 

1, which can appear in a for loop as counter values. Rather than coding numerical 
constants directly, add static final attributes for numeric constants. 
Don't Place Multiple Statements on the Same Line 

Each line should contain at most one statement. For example, for the following 

20 code: 

if( someCondition ) someMethod(); 

i++;j++; 

each statement should be placed on a separate line, as follows: 
if( someCondition ) 
2 5 someMethod() ; 

i++; 

Don't Use the Negation Operator Frequently 

The negation operator slows down the readability of the program, so it is 
30 recommended that it should not be used frequently. The following source code 
illustrates a violation of this rule: 
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boolean isOk = verifySomewhat() 
if ( !isOk ) 

return 0; 

else 

5 return 1; 

The program logic should be changed to avoid negation: 
boolean isOk = verifySomewhat() 
if ( isOk ) 

return 1; 

10 else 

return 0; 

Operator '?:' May Not Be Used 

The operator '?:' makes the code harder to read, than the alternative form with an 
if- statement. Thus, in the following source code: 
1 5 void func (int a) { 

intb= (a= 10) 7 20:30; 

} 

The '?:' operator should be replaced with the appropriate if-else statement, 
void func (int a) { 
20 if (a ==10) 

b = 20; 

else 

b = 30; 

} 

25 Parenthesize Conditional Part of Ternary Conditional Expression 

If an expression containing a binary operator appears before the "?" in the ternary 
"?:" operator, it should be parenthesized. Thus, the following code: 

return x >= 0 ? x : -x; 
should be replaced by: 
30 return (x >= 0) ? x : -x; 
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Put Declarations Only at the Beginning of Blocks 

Declarations should be placed only at the beginning of blocks. A block is any 
code surrounded by curly braces "{" and "}". Waiting to declare variables until their first 
use can confuse the unwary programmer and hamper code portability within the scope. 
5 Thus, in the following source code: 
void myMethod() { 

if (condition) { 
doSomeWork(); 
int int2 = 0; 
10 uselnt2(int2); 
} 

int intl = 0; 
uselntl(intl); 

} 

15 the declarations should be moved to the beginning of the block, as follows: 
void myMethod() { 

int intl = 0; // beginning of method block 
if (condition) { 

int int2 = 0; // beginning of "if block 
20 doSomeWorkO; 

uselnt2(int2); 

} 

uselntl(intl); 

} 

25 Provide Incremental In For-Statement or use while-statement 

This audit checks if the third argument of the for-statement is missing, as shown below: 
for ( Enumeration enum = getEnum(); enum.hasMoreElements(); ) { 
Object o = enum.nextElement(); 
doSomeProc(o); 

30 } 

Either the incremental part of a for-structure must be provided or the for-statement must 
be cast into a while-statement, as shown below: 
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Enumeration enum = getEnum(); 
while (enum.hasMoreElements()) { 

Object o = enum.nextElement(); 

doSomeProc(o); 

5 } 

Replacement For Demand Imports 

Demand import-declarations must be replaced with a list of single import- 
declarations that are actually imported into the compilation unit. In other words, import- 
statements may not end with an asterisk. For example, the following source code 
10 violates this audit: 

import j ava.awt. * ; 
import javax. swing.*; 
class RFDI { 

public static JFrame getFrame (Component com) { 
15 while (com != null) { 

if (com instanceof JFrame) 
return (JFrame)com; 
com = com.getParent(); 

} 

20 return null; 

} 

} 

To remedy the above, the demand imports should be replaced with a list of single import 
declarations, as shown below: 
25 import j ava.awt. Component; 

import javax. swing. JFrame; 
class RFDI { 

public static JFrame getFrame (Component com) { 
while (com != null) { 
30 if (com instanceof JFrame) 

return (JFrame)com; 
com = com.getParentQ; 
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} 

return null; 

} 

} 

5 Switch Statement Should Include a Default Case. 

Every switch statement should include a default case. 
Use Abbreviated Assignment Operator 

The abbreviated assignment operator should be used to write programs more 
rapidly. This also increases the speed of some compilers. Thus, the following source 
10 code: 

void oper () { 

int i = 0; 
i = i + 20; 
i = 30 * i; 

15 } 

should be replaced by: 

void oper 0 { 

int i = 0; 
i += 20; 

20 i *= 30; 

} 

Use 'this' Explicitly To Access Class Members 

'This 1 should be used explicitly to access class members because using the same 
class members' and parameters' names makes references confusing. For example, the 
25 following source code: 

class UTETACM { 
int attr = 10; 
void func () { 

// do something 

30 } 

void oper () { 
func(); 
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attr = 20; 

} 

} 

should be replaced by: 
5 class UTETACM { 

intattr= 10; 
void func 0 { 

// do something 

} 

10 void oper () { 

this.funcO; 
this.attr = 20; 

} 

} 

15 Critical Errors 

Avoid Hiding Inherited Attributes 

This audit detects when attributes declared in child classes hide inherited attributes. 
Thus, in the following source code: 

class Elephant extends Animal { 
20 intattrl; 

// something...; 

class Animal { 
int attrl; 

25 } 

the child class attribute should be renamed, as follows: 
class Elephant extends Animal { 
int elphAttrl; 
// something...; 

30 } 
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class Animal { 
int attrl; 

Avoid Hiding Inherited Static Methods 
5 This audit detects when inherited static operations are hidden by child classes. Thus, in 
the following source code: 

class Elephant extends Animal { 
void operl() {} 
static void oper2() {} 

10 } 

class Animal { 

static void operlQ {} 
static void oper2() {} 

} 

15 either ancestor or descendant class operations should be renamed, as follows: 
class Elephant extends Animal { 
void anOperl () {} 
static void anOper2 () {} 

> 

20 class Animal { 

static void operl() {} 
static void oper2() {} 

Command Query Separation 
25 This audit prevents methods that return a value from modifying state. The 

methods used to query the state of an object must be different from the methods used to 
perform commands (change the state of the object). For example, the following source 
code violates this audit: 

class CQS { 
30 int attr; 

int getAttr () { 

attr += 10; 
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return attr; 

} 

} 

Hiding Of Names 

5 Declarations of names should not hide other declarations of the same name. The 

option 'Formally' regulates whether hiding of names should be detected for parameter 
variable, if the only usage of it is to assign its value to the attribute with the same name. 
Thus, for the following source code: 
class HON { 
10 int index; 

void func () { 

int index; 

// do something 

1 5 void setlndex (int index) { 

this. index — index; 

} 

} 

The variable which hides the attribute or another variable should be renamed, as follows: 
20 class HON { 

int index; 
void func () { 

int index!; 

// do something 

25 } 

void setlndex (int anlndex) { 
this. index = anlndex; 

} 

} 

30 In the above example, the second violation would be raised only if the "formally" option 
is switched on. 
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Inaccessible Constructor Or Method Matches 

Overload resolution only considers constructors and methods that are visible at 
the point of the call. If, however, all the constructors and methods were considered, there 
may be more matches, which would violate this audit. 



ClassA, then the allocation of ClassB violates this rule since the second constructor is not 
visible at the point of the allocation, but it still matches the allocation (based on 
signature). Also the call to oper in ClassB violates this rule since the second and the third 
declarations of oper is not visible at the point of the call, but it still matches the call 
10 (based on signature). 

public class ClassA { 

public ClassA (int param) {} 
ClassA (char param) {} 
ClassA (short param) {} 
15 public void oper (int param) {} 



Either such methods or constructors must be given equal visibility, or their signature 
20 must be changed, as follows: 



5 



For example, in the source code below, if ClassB is in a different package than 



void oper (char param) {} 
void oper (short param) {} 



public class ClassA { 



25 



ClassA (int param) {} 
public ClassA (char param) {} 
public ClassA (short param) {} 
public void oper (int param) {} 
void doOper (char param) {} 
void doOper (short param) {} 



30 



} 

Multiple Visible Declarations With Same Name 

Multiple declarations with the same name must not be simultaneously visible 
except for overloaded methods. Thus, in the following source code: 
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class MVDWSN { 

void index () { 
return; 

> 

5 void func () { 

int index; 

} 

The members (or variables) with clashing names should be renamed, as follows: 
10 class MVDWSN { 

void index () { 
return; 

void func 0 { 
15 int anlndex; 

} 

} 

Overriding a Non- Abstract Method With an Abstract Method 

This audit checks for the overriding of non-abstract methods by abstract methods 
20 in a subclass. For example, in the following source code, the non- abstract method 
"func()" is overridden by the abstract method "func()" in a subclass: 
class Animal { 

void func () {} 

} 

25 abstract class Elephant extends Animal { 

abstract void func (); 

} 

To remedy this audit, the method may be renamed, or the method should be made 
abstract in an ancestor class or non- abstract in a descendant, as follows: 
30 class Animal { 

void func () {} 

} 
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abstract class Elephant extends Animal { 
abstract void extFunc (); 

} 

Overriding a Private Method 
5 A subclass should not contain a method with the same name and signature as in a 

superclass if these methods are declared to be private. Thus, in the following source 
code: 

class Animal { 

private void func () {} 

10 } 

class Elephant extends Animal { 
private void func () {} 

} 

the descendant class' method should be renamed, as follows: 
15 class Animal { 

private void func () {} 

} 

class Elephant extends Animal { 
private void extFunc () {} 

20 } 

Overloading Within a Subclass 

A superclass method may not be overloaded within a subclass unless all 
overloadings in the superclass are also overridden in the subclass. It is very unusual for a 
subclass to be overloading methods in its superclass without also overriding the methods 
25 it is overloading. More frequently this happens due to inconsistent changes between the 
superclass and subclass - i.e., the intention of the user is to override the method in the 
superclass, but due to the error, the subclass method ends up overloading the superclass 
method. The following source code violates this audit: 
public class Elephant extends Animal { 
30 public void oper (char c) {} 

public void oper (Object o) {} 

} 
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class Animal { 

public void oper (int i) {} 
public void oper (Object o) {} 

5 In the above code, the other methods should also be overloaded, as follows: 
public class Elephant extends Animal { 
public void oper (char c) { } 
public void oper (int i) {} 
public void oper (Object o) {} 

10 } 

class Animal { 

public void oper (int i) {} 

} 

Use of Static Attribute for Initialization 
15 Non- final static attributes should not be used in initializations of attributes. Thus, 

in the following source code: 
class ClassA { 

static int state =15; 
static int attrl = state; 
20 static int attr2 = ClassA. state; 

static int attr3 = ClassB. state; 

} 

class ClassB { 

static int state = 25; 

25 } 

The static attributes used for initialization should be made final, or another constant 
should be used for initialization, as follows: 
class ClassA { 

static int state =15; 
30 static final int INITIAL_STATE =15; 

static int attrl = INITIAL_STATE; 
static int attr2 = ClassA.state; 
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static int attr3 = ClassB. state; 

> 

class ClassB { 

static final int state = 25; 

5 } 
Declaration Style 

Badly Located Array Declarators 

Array declarators must be placed next to the type descriptor of their component 
type. Thus, the following source code: 
10 class BLAD { 

int attr[]; 

int oper (int param[]) [] { 
int var[][]; 
// do something 

15 } 
} 

should be replaced by: 

class BLAD { 

int[] attr; 

20 int[] oper (int[] param) { 

int[][] var; 
// do something 

} 

} 

25 Constant Private Attributes Must Be Final 

Private attributes that never get their values changed must be declared final. By 
explicitly declaring them in such a way, a reader of the source code gets some 
information regarding how the attribute should be used. Thus, in the following source 
code: 

30 class CPAMBF { 

int attrl = 10; 
int attr2 = 20; 
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void func () { 

attrl = attr2; 

System.out.println(attrl); 

> 

5 } 

all private attributes that never change should be made final, as follows: 
class CPAMBF { 

int attrl = 10; 
final int attr2 = 20; 
10 void func () { 

attrl = attr2; 

System, out .println(attr 1 ) ; 

} 

} 

15 Constant Variables Must Be Final 

Local variables that never get their values changed must be declared final. By 
explicitly declaring them in such a way, a reader of the source code gets some 
information regarding how the variable should be used. Thus, in the following source 
code: 

20 void func () { 

int varl = 10; 
int var2 = 20; 
varl = var2; 

System.out.println(attrl); 

25 } 

all variables which are never changed should be made final, as follows: 
void func () { 

int varl = 10; 
final int var2 = 20; 
30 varl = var2; 

System.out.println(attrl ); 

} 
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Declare Variables In One Statement Each 

Several variables (attributes and local variables) should not be declared in the 
same statement. The 'different types only 1 option can weaken this rule. When such 
option is chosen, violation is raised only when variables are of different types, for 
5 example: "int foo, fooarray[];" is definitely wrong. To correct the following source 
code: 

class DVIOSE { 
int attrl; 
intattr2, attr3; 
10 void oper () { 

intvarl; 

int var2, var3; 

> 

} 

15 each variable should be declared in separate statements, as follows: 
class DVIOSE { 
int attrl; 
int attr2; 
intattr3; 

20 void oper () { 

int varl ; 
int var2; 
int var3 ; 

> 

25 } 

Instantiated Classes Should Be Final 

This rule recommends making all instantiated classes final. It checks classes 
which are present in the object model. Classes from search/classpath are ignored. In the 
following source code: 
30 class ICSBF { 

private Class 1 attrl = new Class 1(); 
// something... 
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} 

class Class 1 { 

// something... 

> 

5 all instantiated classes should be made final, as follows: 
class ICSBF { 

private Classl attrl = new Classl(); 
// something... 

10 final class Classl { 

// something... 

D > 

yj List All Public And Package Members First 

fys Enforces standard to improve readability. Methods and/or data in classes should 

;S 15 be ordered properly. Thus, in the following source code: 

Rj class LAPAPMF { 

w s private int attr; 

□ public void oper () {} 

20 Public and package members should be placed before protected and private ones, as 
follows: 

class LAPAPMF { 

public void oper () {} 
private int attr; 

25 } 

Order of Class Members Declaration 

The parts of a class or interface declaration should appear in the following order: 
1. Class (static) variables. First the public class variables, then the protected, then 
package level (no access modifier), and then the private. 
30 2. Instance variables. First the public class variables, then the protected, then 
package level (no access modifier), and then the private. 
3. Constructors. 
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Order Of Appearance Of Modifiers 

This audit checks for correct ordering of modifiers. For classes, the ordering is: 
visibility (public, protected or private), abstract, static, final. For attributes, the ordering 
5 is: visibility (public, protected or private), static, final, transient, volatile. For 
operations, the ordering is: visibility (public, protected or private), abstract, static, final, 
synchronized, native. Thus, the following source code is incorrect: 



} 

Put the Main Function Last 

This audit requires that in class definitions, the main function should be placed 
later in the definition. Thus, the following source code: 



10 



final public class OOAOM { 

public static final int attrl; 
static public int attr2; 

} 

The order of modifiers above should be changed, as follows: 
public final class OOAOM { 

public static final int attrl; 
public static int attr2; 



R 20 



public class PMFL { 



void fund () {} 

public static void main (String args[]) {} 
void func2 () {} 



} 



25 



should be modified to: 



public class PMFL { 



public static void main (String args[]) {} 
void fund () {} 
void func2 () {} 



30 



} 
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Place Public Class First 

The public class or interface should be the first class or interface in the file. 
Thus, the following source code: 
class Helper { 
5 // some code 

} 

public class PPCM { 
// some code 

> 

10 should be modified to: 

public class PPCM { 
// some code 

} 

class Helper { 
15 // some code 

> 

Documentation 

Bad Tag In JavaDoc Comments 

This audit prevents the accidental use of improper JavaDoc tags. The following 
20 example illustrates the use of a bad tag: 
package audit; 
/** Class BTIJDC 

* @BAD_TAG_1 

* ©version 1.0 08-Jan-2000 
25 * ©author TogetherSoft 

*/ 

public class BTIJDC { 
/** 

* Attribute attr 
30 * @BAD_TAG_2 

* @supplierCardinality 0.. 

* @clientCardinality 1 
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*/ 

private int attr; 
/** Operation oper 

* @BAD_TAG_3 
5 * @return int 

*/ 

public int oper () {} 

} 

The misspelled tags in the above code should be replaced, or any non-standard tags 
10 should be added to the list of valid tags. 

Distinguish Between JavaDoc And Ordinary Comments 

This audit checks whether JavaDoc comments end with '**/' and ordinary C-style 
documents end with '*/'. Thus, the following code: 
package audit; 
15 /** 

* JavaDoc comment 
*/ 

public class DBJAOC { 
/* 

20 * C-style comment 

**/ 

private int attr; 
/** 

* JavaDoc comment 
25 */ 

public void oper () {} 

> 

should be replaced by: 

package audit; 
30 /** 

* JavaDoc comment 
**/ 
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public class DBJAOC { 
/* 

* C-style comment 
*/ 

5 private int attr; 

/** 

* JavaDoc comment 
public void oper () {} 

10 } 

Provide File Comments 

All source files should begin with a c-style comment that lists the class name, 
version information, date, and copyright notice, as follows 
/* 

15 * Classname 

* Version information 

* Date 

* Copyright notice 
*/ 

20 This audit verifies whether the file begins with a c-style comment. 
Provide JavaDoc Comments 

This audit checks whether JavaDoc comments are provided for classes, 
interfaces, methods and attributes. 
Naming Style 
25 Class Name Must Match Its File Name 

This audit checks whether the top level class and/or interface has the same name 
as the file in which it resides. Thus, in the following source code: 
// File Audit_CNMMIFN.java 
class CNMMIFN {} 
30 the class or file should be renamed, as follows: 
// File Audit_CNMMIFN.java 
class Audit_CNMMIFN {} 
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Group Operations With Same Name Toeether 

This audit requires that group operations with the same name be placed together 
to improve readability. Thus, the following example: 
package audit; 
5 class GOWSNT { 

void operation () {} 

void function () {} 

void operation (int param) {} 

10 should be modified, as follows: 
package audit; 
class GOWSNT { 

void operation () {} 
void operation (int param) {} 
15 void function () {} 

Naming Conventions 

This audit takes a regular expression and item name and reports all occurrences 
where the pattern does not match the declaration. Thus, in the following example, 
20 package _audit; class _AuditNC { 

void operation 1 (int Parameter) { 
void Operation2 (int parameter) { 
int variable; 

2 5 int my_attribute ; 

final static int constant; 

} 

The packages, classes, members etc., should be renamed in a proper way, as follows: 
package audit; class AuditNC { 
30 void operationl (int parameter) { 

void operation2 (int parameter) { 
int variable; 
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} 

int my Attribute; 

final static int CONSTANT; 

} 

5 Names Of Exception Classes 

Names of classes which inherit from Exception should end with Exception. 
Thus, the following source code: 

class AuditException extends Exception {} 
class NOEC extends Exception {} 
10 should be modified to renmae the exception classes, as follows: 
class AuditException extends Exception {} 
class NOECException extends Exception {} 
Use Conventional Variable Names 

One-character local variable or parameter names should be avoided, except for 
15 temporary and looping variables, or where a variable holds an undistinguished value of a 
type. Conventional one-character names are: 
b for a byte 
c for a char 
d for a double 
20 e for an Exception 

f for a float 
i, j, k for integers 
1 for a long 
o for an Object 
25 s for a String 

Local variable or parameter names that consist of only two or three uppercase letters 
should be avoided to avoid potential conflicts with the initial country codes and domain 
names that are the first component of unique package names. 

The following source code does not give conventional names to all local 
30 variables: 

void func (double d) { 
int i; 
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Object o; 
Exception e; 
char s; 
Object f; 

5 String k; 

Object UK; 

} 

and should be replaced by: 

void func (double d) { 
10 int i; 

Object o; 
Exception e; 
char c; 
Object o; 

15 Strings; 

Object ol; 

Performance 

Avoid Declaring Variables Inside Loops 
20 This rule recommends that local variables be declared outside the loops because 

declaring variables inside the loop is less efficient. Thus, in the following source code: 
int good_var = 0; 
for (int i = 0; i < 100; i++) { 
int varl = 0; 
25 // ... 

} 

while (true) { 

int var2 = 0; 
//... 

30 } 

do { 

int var3 = 0; 
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II ... 

} while (true); 

the variable declarations should be moved out of the loop, as follows: 
int goodvar — 0; 
5 int varl ; 

for (int i = 0; i < 100; i++) { 
varl = 0; 
// ... 

} 

10 intvar2; 

while (true) { 

var2 = 0; 

II ... 

} 

15 intvar3; 

do { 

var3 = 0; 
//... 
} while (true); 
20 Append To String Within a Loop 

Performance enhancements can be obtained by replacing String operations with 
StringBuffer operations if a String object is appended within a loop. Thus, in the 
following example source code: 

public class ATSWL { 
25 public String fimc () { 

String var = "var"; 
for(inti = 0;i< 10; i++) { 
var (" " + i); 

} 

30 return var; 

} 
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StringBuffer class should be used instead of String, as follows: 
public class ATS WL { 

public String func () { 

StringBuffer var = new StringBuffer("var"); 
5 for(inti = 0;i<10;i++) { 

var.append(" " + i); 

} 

return var.toString(); 

} 

10 } 

Complex Loop Expressions 

Avoid using complex expressions as repeat conditions within loops. The 
following source code violates this audit by using "vector.size()" within a condition of a 
"for" loop: 
1 5 void oper () { 

for (int i = 0; i < vector. size(); i++) { 
// do something 

} 

int size = vector.size(); 
20 for (int i = 0; i < size; i++) { 

// do something 

} 

} 

In the above code, the expression "vector.size()" should be assigned to a variable before 
25 the loop, and that variable should be used in the loop, as follows: 
void oper () { 

int size = vector. size(); 
for (int i = 0; i < size; i++) { 
// do something 

30 } 

int size = vector. size(); 

for (int i = 0; i < size; i++) { 
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// do something 



} 



Possible Errors 

5 Avoid Empty Catch Blocks 

Catch blocks should not be empty. Programmers frequently forget to process 
negative outcomes of a program and tend to focus more on the positive outcomes. 

When the 'Check parameter usage* option is chosen, this rule also checks whether 
the code does something with the exception parameter or not. If not, a violation is 
10 raised. 

Avoid Public And Package Attributes 

Public and package attributes should be avoided. Rather, the attributes should be 
declared either private or protected, and operations should be provided to access or 
change the attribute declarations. 
15 class APAPA { 



} 

The visibility of attributes should be changed to either private or protected, and access 
20 operations for these attributes should be provided, as follows: 
class APAPA { 



int attrl; 



public int attr2; 



private int attrl ; 
protected int attr2; 
public int getAttrlQ { 



25 



return attrl; 



} 

public int getAttr2() { 



return attr2; 

> 
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public void setAttr2(int newVal) { 
attr2 = newVal; 

} 

} 

5 Avoid Statements With Empty Body 

Statements having empty bodies should be avoided. For example, in the 
following source code: 

StringTokenizer st = new StringTokenizer(classl.getName(), true); 
String s; 

10 for( s = ""; st.countTokens() > 2; 

s = s + st.nextToken() ); 
a statement body should be provided. In the alternative, the logic of the program may be 
changed. For example, the "for" statement can be replaced by a "while" statement, as 
follows: 

15 StringTokenizer st = new StringTokenizer(classl.getName(), true); 

String s = ""; 

while( st.countTokens() > 2 ) { 
s += st.nextToken(); 

} 

20 Assignment To For-Loop Variables 

For-loop variables should not be assigned a value. For example, the for-loop 
variable "i" should not be assigned the value i++ as follows: 
for (int i = 0; i < charBuf.length; i++) { 

while ( Character.isWhitespace(charBuf[i]) ) 
25 i++; 

} 

A continue operator should be used to correct the above code, as follows: 
for (int i = 0; i < charBuf.length; i++) { 
30 while ( Character.isWhitespace(charBuf[i]) ) 

continue; 
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} 

In the alternative, the for-loop may be converted to a while-loop. 
Don't Compare Floating Point Types 

Avoid testing floating point numbers for equality. Floating-point numbers that 
5 should be equal are not exactly equal due to rounding problems. Thus, the direct 
comparison in the following code: 

void oper (double d) { 

if( d != 15.0 ) { 

for ( double f= 0.0; f<d;f+= 1.0) { 
10 //do something 

} 

} 

} 

should be replaced with an estimation of the absolute value of the difference, as follows: 
15 void oper (double d) { 

if ( Math.abs(d - 15.0) < Double.MIN_VALUE * 2 ) { 
for ( double f = 0.0; d - f > DIFF; f += 1.0 ) { 
// do something 

} 

20 } 
} 

Enclosing Body Within a Block 

The statement of a loop must always be a block. The then and else parts of if - 
statements must always be blocks. This makes it easier to add statements without 
25 accidentally introducing bugs due to missing braces. Thus, the following code is missing 
braces for both the if-loop and the while-loop: 
if( st = null ) 
return; 

while( st.countTokens() > 2 ) 
30 s += st.nextTokenQ; 
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The correct form for the above code is as follows: 
if(st = null) { 
return; 

} 

5 while( st.countTokensO > 2 ) { 

s += st.nextToken(); 

} 

Explicitly Initialize All Variables 

All variables should explicitly be initialized. The only reason not to initialize a 
10 declared variable is if the initial value depends on a previous computation. For example, 
the following source code violates this rule since varO and var 2 are not initialized: 
void func () { 

int varO; 

int varl = 1, var2; 
15 //do something.. } 

The correct form for the above source code is as follows: 
void func () { 

int varO = 0; 
int varl = 1, var2 = 0; 
20 // do something.. 

Method finalized Doesn't Call super. finalizeO 

It is a good practice of programming to call super. finalize() from finalize(), even 
if the base class doesn't define the finalize() method. This makes class implementations 
25 less dependent on each other. Thus, the following source code: 
void finalize () { 

should be modified to: 

void finalize () { 
3 0 super. finalize() ; 
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Mixing Logical Operators Without Parentheses 

An expression containing multiple logical operators together should be 
parenthesized properly. Thus, in the following source code: 
void oper () { 
5 boolean a, b, c; 

// do something 
if( a||b&&c) { 

// do something 
return; 

10 } 

} 

the parenthesis should be used to clarify complex logical expression to the reader, as 
follows: 

void oper () { 
15 boolean a, b, c; 

// do something 
if( a || (b && c) ) { 

// do something 
return; 

20 } 
} 

No Assignments In Conditional Expressions 

Assignments within conditions should be avoided since they make the source 
code difficult to understand. For example, the following source code: 
25 if ( (dir = new File(targetDir)).exists() ) { 

// do something 

} 

should be replaced by: 

dir = new File(targetDir); 
30 if (dir.exists()) { 

// do something 

} 



11 259732v 1 



-64- 



Supply Break or Comment in Case Statement 

Every time a case falls through and doesn't include a break statement, a comment 
should be added where the break statement would normally be. The break in the default 
case is redundant, but it prevents a fall-through error if later another case is added. Thus 
5 in the following source code: 
switch( c ) { 

case 'n f : 

result += '\n'; 
break; 

10 case Y: 

result V; 
break; 

case V: 

someFlag = true; 
15 case'V": 

result += c; 
break; 
// some more code... 

} 

20 a /* falls through */ comment should be added, as follows: 
switch( c ) { 

case 'n 1 : 

result += '\n'; 
break; 

25 case V: 

result 4= V; 
break; 

case T: 

someFlag = true; 
30 /* falls through */; 

case V": 

result += c; 
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break; 
// some more code... 

} 

Use 'equals' Instead Of =' 
5 The '= 1 operator is used on strings to check if two string objects are identical. 

However, in most cases, one would like to check if two strings have the same value. In 
these cases, the 'equals 1 method should be used. Thus, the following source code: 
void func (String strl, String str2) { 
if(strl =str2) { 
10 // do something 

} 

should be replaced by: 

void func (String strl, String str2) { 
15 if(strl.equals(str2)) { 

// do something 

> 

Use 'L' Instead Of T at the end of integer constant 
20 It is difficult to distinguish between lower case letter T and digit T. As far as 

the letter T can be used as a long modifier at the end of integer constant, it can be mixed 
with the digit. Thus, it is better to use an uppercase 'L'. In the following example: 
void func () { 

long var = 0x0001 11 11; 

25 } 

the trailing T letter at the end of integer constants should be replaced with f L,' as follows: 
void func () { 

long var = 0x0001 111L; 

} 

30 Use Of the 'synchronized 1 Modifier 

The 'synchronized' modifier on methods can sometimes cause confusion during 
maintenance and debugging. This rule recommends avoiding the use of this modifier 
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and encourages using 'synchronized' statements instead. Thus, in the following source 
code: 

class UOSM { 

public synchronized void method () { 
5 // do something 

} 

} 

synchronized statements should be used instead of synchronized methods, as follows: 
class UOSM { 
10 public void method () { 

synchronized(this) { 

// do something 

} 

} 

15 } 

Superfluous Content 

Duplicate Import Declarations 

There should be only one import declaration that imports a particular 
class/package. The following source code violates this audit by containing multiple 
20 import declarations for java.io.* and java.sql.time: 
package audit; 
import java.io.*; 
import java.io.*; 
import java.sql.Time; 
25 import java.sql.Time; 

class DID { 
} 

To correct the above code, duplicate declarations should be deleted. 
Don't Import the Package the Source File Belongs To 
30 No classes or interfaces need to be imported from the package that the source 

code file belongs to. Everything in that package is available without explicit import 
statements. Thus, the following source code contains the unnecessary import of "audit": 
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package audit; 
import j ava. awt . * ; 
import audit.*; 
public class DIPSFBT { 

5 } 

To correct the above code, the unnecessary import statement should be deleted. 
Explicit Import Of the iava.lang Classes 

Explicit import of classes from the package 'java.lang 1 should not be performed. 
Thus, in the following source code, the unnecessary import of "java.lang.*" should be 
10 deleted: 

package audit; 
import j ava. lang. * ; 
class EIOJLC {} 
Equality Operations On Boolean Arguments 
15 Avoid performing equality operations on boolean operands. True and false 

literals should not be used in conditional clauses, as shown below: 
int oper (boolean bOk) { 
if (bOk) { 

return 1 ; 

20 } 

while ( bOk = true ) { 
// do something 

} 

return ( bOk = false ) ? 1 : 0; 

25 } 

The above source code should be replaced with the following: 
int oper (boolean bOk) { 
if (bOk) { 

return 1; 

30 } 

while ( bOk ) { 

// do something 
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} 

return ( ! bOk ) ? 1 : 0; 

} 

Imported Items Must Be Used 
5 It is not legal to import a class or an interface and never use it. This audit checks 

classes and interfaces that are explicitly imported with their names, not those with import 
of a complete package, i.e., using an asterisk. If unused class and interface imports are 
omitted, the amount of meaningless source code is reduced, thus the amount of code to 
be understood by a reader is minimized. Thus, the unnecessary import of "stack" in the 
10 following source code should be deleted: 
import j ava. awt . * ; 
import java.util. Dictionary; 
•jg import java.util.Hashtable; 

'f;\ import java.util. Stack; 

tfl 15 import java.util. Vector; 

m class IIMBU { 

y = Dictionary diet; 

O void func (Vector vec) { 

pH Hashtable ht; 

5 20 // do something 

} 

Unnecessary Casts 

This audit checks for the use of type casts that are not necessary. A cast is a 
25 Java™ language construct that performs a narrowing conversion. Thus, in the following 
example the cast "(elephant) el" is not necessary since el is already defined as type 
elephant: 

class Animal {} 

class Elephant extends Animal { 
30 void func () { 

int i; 

float f= (float) i; 
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Elephant el; 

Elephant e2 = (Elephant) el; 



5 Animal a; 

Elephant e; 
a = (Animal) e; 

} 

} 

10 In the above example, the unnecessary cast should be deleted to improve readability. 
Unnecessary 'instanceof Evaluations 

This audit determines whether the runtime type of the left-hand side expression is 
the same as the one specified on the right-hand side. Thus, in the following source code, 
the "if-loops" are unnecessary since both statements within the if loop are defined to be 
15 true. In particular, "Animal animal" defines animal as type Animal, "Elephant elephant" 

Ul 

[lj defines elephant as type Elephant, and "class Elephant extends Animal {}" defines 

~ H Elephant to be the same type as Animal. Thus, elephant is also defined as type 

□ "Animal." 

m class UIOE { 

if 20 void operation () { 

M Animal animal; 

Elephant elephant; 

if ( animal instanceof Animal ) { 
doSomethingl (animal); 

25 } 

if ( elephant instanceof Animal ) { 
doSomething2(elephant); 

30 } 

class Animal {} 

class Elephant extends Animal {} 
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To correct the above code, the if-loops can be removed, as follows: 
class UIOE { 

void operation () { 

Animal animal; 
5 Elephant elephant; 

doSomethingl (animal); 
doSomething2(elephant) ; 

} 

} 

10 class Animal {} 

class Elephant extends Animal {} 
Unused Local Variables And Formal Parameters 

Local variables and formal parameters declarations must be used. Thus, in the 
following source code, the unused local variables and formal parameters should not be 
15 used. 

int oper (int unused_param, int used_param) { 
int unused_var; 
return 2 * used_param; 

} 

20 Use Of Obsolete Interface Modifier 

The modifier 'abstract, 1 as shown in the following code, is considered obsolete 
and should not be used: 

abstract interface UOOIM {} 
The above source code should be replaced by the following: 
25 interface UOOIM {} 

Use Of Unnecessary Interface Member Modifiers 

All interface operations are implicitly public and abstract. All interface attributes 
are implicitly public, final and static. Thus, the following source code contains 
unnecessary interface member modifiers: 
30 interface UOUIMM { 

int attrl ; 

public final static int ATTR2; 
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void operl (); 

public abstract void oper2 (); 

} 

The above code may be corrected, as follows: 
5 interface UOUIMM { 

int attrl; 

final static int ATTR2; 
void operl (); 
void oper2 (); 

10 } 

Unused Private Class Member 

An unused class member might indicate a logical flaw in the program. The class 
declaration has to be reconsidered in order to determine the need of the unused 
member(s). Thus, in the following source code, the unnecessary members, i.e., 
1 5 "badattr" and "bad_oper() 5 " should be removed, 
class UPCM { 

private int bad_attr; 
private int good_attr; 
private void bad_oper () { 
20 // do something...; 

} 

private void good operl () { 
good_attr =10; 

25 public void good_oper2() { 

good_operl(); 

} 

} 

Unnecessary Return statement Parentheses 
30 A return statement with a value should not use parentheses unless it makes the 

return value more obvious in some way. For example, the following source code 
violates this audit: 
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• 



return; 



return (myDisk.size()); 

return (sizeOk ? size: defaultSize); 



and should be replaced by: 



return; 



return myDisk.size(); 

return (sizeOk ? size : defaultSize); 



Locating Source Code Referenced By Verification Tool 

The QA module is a verification tool. Conventional compilers are also 

10 verification tools, which provide messages to the user if an error is detected within the 
source code. The software development tool in accordance with methods and systems 
consistent with the present invention uses the error message from the verification tool to 
locate the source code corresponding to the message. Thus, the developer can use the 
improved software development tool to determine which line of source code corresponds 

15 to an error message from a verification tool. The verification tool may be part of the 
software development tool, or it may be external to the software development tool. 

Figs. 20 A and B depict a flow diagram illustrating how the software development 
tool allows a developer to quickly locate source code referenced by a verification tool. 
The first step performed by the software development tool is to display the textual 

20 representation of the source code in a project (step 2000 in Fig. 20A). The software 
development tool simultaneously displays the graphical representation of the source code 
in the project (step 2002). For example, Fig. 21 depicts screen 2100 with both a textual 
representation 2102 and a graphical representation 2104 of a project 2106. The screen 
2100 also displays the error messages 2108 received from the audit option of the QA 

25 module. The error messages 2108 include the severity 2110 of the message, the 
abbreviation 2112 used to identify the message, an explanation 21 14 of the message, the 
element 21 16 in which the error occurs, the item 2118 to which the error refers, the file 
2120 in which the error occurs, and the line number 2122 of the source code where the 
error occurs. 

30 The choices for the severity 2110 are low, normal, and high. An example of an 

audit error message having low severity is "Avoid Too Long Files" ("ATLF"), which 
occurs when a file contains more than 2000 lines. According to standard code 
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conventions for the Java™ programming language, having more than 2000 lines are 
cumbersome and should be avoided. Because this audit identifies a suggested format 
that will not affect the compilation or execution of the source code, it is considered a low 
severity message. The explanation 2114 of this message is "Avoid Too Long Files," and 
5 the message uses the abbreviation 2112 "ATLF." This message relates to a file that 
contains more than 2000 lines. Thus, the item 2118 to which the message occurs 
identifies the file name. The file 2120 in which the error occurs also identifies the same 
file, but includes the path to the file with the file name. With the ATLF audit, the line 
number 2122 of the source code where the error occurs is 2001 because the audit feature 

10 will not identify this error until it reaches the 2001st line of the source code. An example 
of a "normal" severity message is "Use Abbreviated Assignment Operator" ("UAAO"). 
The abbreviated assignment operator is preferred in order to write programs more rapidly 
and because some compilers run faster using abbreviated assignment operators. 
Although the failure to use the abbreviated assignment operator may slow the 

15 compilation of the source code, it will not prevent the program from compiling or 
executing properly, and is thus not a high severity message. Because of its effect on the 
compilation time, however, the failure to use the abbreviated assignment operator is 
considered a normal severity message rather than a low severity message. Finally, a high 
priority message is one that will prevent the source code from executing properly. For 

20 example, "Avoid Hiding Inherited Static Methods" ("AHISM") identifies when inherited 
static operations are hidden by child classes. Thus, if the same term is used to define a 
class field in both a parent and a child class, the software development tool will use the 
same definition in both cases because the term is defined more than once within the 
project, thus making it ambiguous. 

25 Returning to the flow diagram in Fig. 20A, when a developer chooses one of the 

messages 2108, the software development tool receives the message 2108 from the 
verification tool (step 2004). As discussed above, the message 2108 includes the file 
2120 in which the error occurs and the line number 2122 of the source code where the 
error occurs. Thus, in the example shown, the software development tool obtains this 

30 information and uses it to locate the source code corresponding to the message 2108 
(step 2006). If the text of the source code corresponding to the message 2108 is not 
displayed (step 2008), the software development tool displays the source code 
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corresponding to the message (step 2010). The software development tool then displays 
the source code corresponding to the message in a visually distinctive manner, e.g., the 
software development tool may highlight, italicize, or bold the source code, or it may 
display the code in a different color or with a different color background (step 2012 in 
5 Fig. 20B). Thus, if a developer chooses the "Avoids Too Long Lines" message 2202 
shown on the screen 2200 in Fig. 22, the software development tool finds line number 
2204 located in the file 2206 at C:\Together4.2\samples\java\Hello\Hello..., determines 
that the line is not currently displayed, and displays it in a visually distinctive manner, as 
shown on the screen 2300 in Fig. 23. The software development tool then determines 

10 whether the graphical representation 2306 of the source code corresponding to the 
message is displayed (step 2014). If the graphical representation is not displayed, the 
software development tool displays the graphical representation 2306 of the source code 
corresponding to the message (step 2016). The software development tool then displays 
the graphical representation 2306 of the source code in a visually distinctive manner, 

15 e.g., the software development tool may highlight the graphical representation 2306, 
change its color, or change the color of its background (step 2018). Thus, in the example 
shown, the software development tool determines that the graphical representation 2306 
of the message is shown, and modifies its representation in a visually distinctive manner. 
Although discussed in terms of the audit function of the QA module, the software 

20 development tool of the present invention may also use other verification tools to receive 
messages and locate specific lines of source code referenced by the message. These 
verification tools may be integrated into the software development tool, as in the case of 
the QA module, or may be external to the software development tool. Any verification 
tool known in the art may be used, and any known technique to locate the line of source 

25 code may be used. 

While various embodiments of the present invention have been described, it will 
be apparent to those of skill in the art that many more embodiments and implementations 
are possible that are within the scope of this invention. Accordingly, the present 
invention is not to be restricted except in light of the attached claims and their 

30 equivalents. 
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